Release 10.1A: OpenEdge Getting Started:
WebSpeed Essentials

Managing the WebSpeed Transaction Server

The WebSpeed Transaction Server is a background process and, as such, does not present a visual interface to the administrator. However, you can manage the Transaction Server with the WTBMAN utility, and you can validate its properties in the ubroker.properties file with the WSCONFIG utility. The WTBMAN utility commands can run remotely; the WSCONFIG utility commands only run locally.

In addition to allowing you to start, query, or stop the Transaction Server, the WTBMAN utility lets you do the following:

Start additional agents.
Trim the number of agents.
Stop the Transaction Server.
Display command-line help.

Dynamically starting additional agents

To start additional agents, enter the following command:

wtbman -name broker -addagents number-to-start

Where broker is the name of the WebSpeed broker specified in the ubroker.properties file and number-to-start is the number of additional agents you want to start. The number you specify must not exceed the maxSrvInstance value in the ubroker.properties file or your license limit.

Trimming running agents

To trim agents, enter the following command:

wtbman -name broker -trimagents number-to-trim

Where broker is the name of the Transaction Server and number-to-trim is the number of agents you want to stop.

Stopping the WebSpeed broker

To stop the broker and all the agents in its pool, enter the following command:

wtbman -name broker -stop

To force an immediate shutdown of the Transaction Server and all its agents, enter the following command:

wtbman -kill broker

Accessing help on WTBMAN

To get information on WTBMAN syntax and usage, enter the following command:

wtbman -help